home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sgi.lha / Geomview / man / cat1 / geomstuff.1 < prev    next >
Text File  |  1993-11-01  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. STUFF(1)                         STUFF(1)
  5.  
  6.  
  7. NAME
  8.        stuff - send OOGL objects to geomview
  9.  
  10. SYNOPSIS
  11.        stuff [-Mpipedirectory]    symbolname  [OOGLfile]
  12.  
  13. DESCRIPTION
  14.        Stuff  sends  a    stream of OOGL-format geometric    data to    a
  15.        cooperating copy    of geomview.  It's intended as a  partial
  16.        emulation of the    old ``stuff'' program which wrote objects
  17.        into shared memory for viewing by a cooperating MinneView.
  18.  
  19.        Typical usage is:
  20.         someprogram    | stuff    fred
  21.         geomview -M    fred
  22.        i.e.  a    program     pipes geometric data into ``stuff''; the
  23.        data is displayed by a copy of geomview run  with  the  -M
  24.        option and a name matching the one given    to stuff.
  25.  
  26.        This  version  of  stuff     uses a    named pipe to communicate
  27.        with the    viewer.     By default, the named pipe is created in
  28.        the  directory  /tmp/geomview.  The -M option specifies an
  29.        alternate directory.
  30.  
  31. FILES
  32.        /tmp/geomview
  33.  
  34. BUGS
  35.        The  pipe-based    communications    scheme    imposes      several
  36.        restrictions.
  37.  
  38.        If  no  copy  of     geomview is reading from the pipe, or if
  39.        geomview    gets far enough    behind,    a program writing data to
  40.        ``stuff''  will    be  forced  to    block after sending a few
  41.        kilobytes.
  42.  
  43.        Because of the buffering    in the pipe, the  sender  may  be
  44.        substantially ahead of the geomview display.
  45.  
  46.        If  geomview  exits, the    sending    program    receives a write-
  47.        on-broken-pipe (SIGPIPE)    signal,    which will kill    it unless
  48.        measures    are taken to catch or ignore that signal.
  49.  
  50.        Only  one copy of geomview can read from    a given    pipe at    a
  51.        time.  If a second copy attempts    to  read  from    it,  both
  52.        will probably fail.
  53.  
  54. SEE ALSO
  55.        geomview(1), oogl(5)
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Geometry Center         23 February 1992            1
  65.  
  66.  
  67.